# git switch

## 개요

git switch`는 Git 2.23 버에서 도입된령어로, 브랜치 전환 switching)을 보다 명하고 직관적으로 수행하기 위해 추가되었습니다. 기존에는 `git checkout` 명령어를 사용하여 브랜치 전환 파일 복원 두 가지 목적을 동시에 사용했지만, 이로 인해령어의 의미가 모호해질 수 있었습니다. `git switch`는 브랜치 전환에 특화된 명령어로, 사용자 경험을 개선하고 명령어의 목적을 명확히 하기 위한 노력의 일환입니다.

이 문서는 `git switch` 명령어의 기본 사용법, 주요 옵션, 실용적인 예시, 그리고 관련 명령어와의 비교를 통해 효과적으로 활용하는 방법을 설명합니다.

## 기본 사용법

`git switch` 명령어의 기본 구문은 다음과 같습니다:

```bash
git switch <브랜치-이름>
```

예를 들어, 현재 작업 중인 브랜치에서 `develop` 브랜치로 전환하려면:

```bash
git switch develop
```

이 명령은 `develop` 브랜치가 존재할 경우 그 브랜치로 전환합니다. 전환 전에 변경 사항이 있는 경우, Git은 해당 변경 사항이 충돌하지 않는지 확인하며, 충돌이 발생할 수 있으면 전환을 막습니다.

## 주요 옵션

### -c, --create: 새로운 브랜치 생성 및 전환

`-c` 옵션을 사용하면 새로운 브랜치를 생성하면서 즉시 그 브랜치로 전환할 수 있습니다.

```bash
git switch -c feature/login
```

이 명령은 `feature/login`이라는 새로운 브랜치를 현재 커밋을 기준으로 생성하고, 그 브랜치로 전환합니다. 이는 다음 두 명령을 합친 것과 동일합니다:

```bash
git branch feature/login
git switch feature/login
```

### -C, --force-create: 기존 브랜치 덮어쓰기

`-C` 옵션은 기존 브랜치가 있어도 강제로 덮어쓰고 전환합니다. 주의해서 사용해야 하며, 기존 브랜치의 커밋 히스토리가 손실될 수 있습니다.

```bash
git switch -C hotfix/critical
```

### -d, --detach: 분리된 HEAD 상태로 전환

`-d` 옵션을 사용하면 특정 커밋으로 HEAD를 분리(detached HEAD) 상태로 전환할 수 있습니다. 이는 태그나 특정 커밋을 확인할 때 유용합니다.

```bash
git switch --detach v1.2.0
```

### -f, --force: 변경 사항 강제 전환

작업 디렉터리에 변경 사항이 있어도 강제로 브랜치 전환을 수행합니다. 기존 변경 사항은 덮어쓰거나 손실될 수 있으므로 주의가 필요합니다.

```bash
git switch -f main
```

## 실용적인 사용 예시

### 1. 기능 브랜치 생성 및 전환

새로운 기능을 개발할 때, `git switch -c`를 사용하면 빠르게 브랜치를 생성하고 전환할 수 있습니다.

```bash
git switch -c feature/user-profile
```

이후 이 브랜치에서 작업을 진행하고, 완료 후 `main` 브랜치로 병합하면 됩니다.

### 2. 이전 브랜치로 돌아가기

`-` 기호를 사용하면 가장 최근에 사용한 브랜치로 돌아갈 수 있습니다.

```bash
git switch -
```

예를 들어, `main` → `develop`로 전환한 후 다시 `main`으로 돌아가고 싶을 때 유용합니다.

### 3. 원격 브랜치 추적 설정

원격 저장소에 있는 브랜치를 로컬에서 사용하려면, `-c`와 함께 `--track` 옵션을 사용합니다.

```bash
git switch -c feature/new-ui --track origin/feature/new-ui
```

이 명령은 원격 브랜치 `origin/feature/new-ui`를 추적하는 로컬 브랜치 `feature/new-ui`를 생성하고 전환합니다.

## git switch vs git checkout

| 기능 | `git switch` | `git checkout` |
|------|-------------|----------------|
| 브랜치 전환 | ✅ (전용) | ✅ |
| 새로운 브랜치 생성 | ✅ (`-c`) | ✅ (`-b`) |
| 파일 복원 | ❌ | ✅ |
| 분리된 HEAD 전환 | ✅ (`--detach`) | ✅ |

`git switch`는 브랜치 전환에만 집중하도록 설계되어 있어, 명령어의 의도가 더 명확합니다. 반면 `git checkout`은 브랜치 전환과 파일 복원이라는 두 가지 서로 다른 작업을 수행하므로, 사용자가 혼동할 수 있습니다. 따라서 브랜치 전환 시 `git switch`를 사용하고, 파일 복원 시 `git restore`를 사용하는 것이 권장되는 모던 Git 워크플로우입니다.

## 참고 자료 및 관련 문서

- [Git 공식 문서 - git-switch](https://git-scm.com/docs/git-switch)
- `git restore`: 파일 상태 복원을 위한 명령어
- `git checkout`: `git switch` 이전의 브랜치 전환 명령어
- `git branch`: 브랜치 관리 명령어

## 결론

`git switch`는 Git 사용자에게 보다 직관적이고 안전한 브랜치 전환 경험을 제공하는 현대적인 명령어입니다. 특히 팀 협업 환경에서 명확한 브랜치 전환 의도를 표현하고, 실수를 줄이는 데 큰 도움이 됩니다. 새로운 Git 사용자라면 `git switch`와 `git restore`를 중심으로 작업하는 것이 학습과 유지보수 측면에서 유리합니다.